home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / serial / callback.001 / callback~ / callback / INSTALL < prev   
Text File  |  1996-07-23  |  4KB  |  145 lines
  1. Here are the installation instructions for cb.
  2.  
  3. For more information, the file 'callback.doc' should be consulted, or send an
  4. e-mail to frank@icce.rug.nl
  5.  
  6. Preliminary
  7. -----------
  8.  
  9.     0.  Callback version 3.00 and above assumes mgetty as the program 
  10.         listening to the modemline. The file mgetty-HOWTO describes in a 
  11.         nutshell what switching from getty-ps to mgetty involves. 
  12.         Beyond it is assumed that mgetty is installed on your system.
  13.  
  14. How to compile the software.
  15. ----------------------------
  16.  
  17.     0. This section only defines how to compile and install the binaries.
  18.        Using the programs is described in callback.doc.
  19.  
  20.  
  21.     1. unpack callback-X.YY.tgz:
  22.  
  23.         tar xzvf callback-X.YY.tgz
  24.  
  25.     This will create a directory callback, un which the software can be
  26.     found
  27.  
  28.  
  29.     2. cd callback
  30.  
  31.     All instructions are relative to this directory, unless explicitly
  32.     mentioned otherwise.
  33.     
  34.     3.  The installation script 'build' assumes that you have icmake installed
  35.     on your system. Icmake are found in ftp.icce.rug.nl, /pub/unix
  36.     From now on it is assumed that you have icmake available.
  37.  
  38.     4. All compile-time definitions are found in the file 'configure.h'
  39.         If any define doesn't suit you, change them to values more 
  40.     appropriate to your system, and rebuild the software, by doing
  41.         'build progs'.
  42.  
  43.     5.    Give the command
  44.  
  45.         build progs
  46.  
  47.     to build the programs.
  48.  
  49.     The compilation of parser.tab.c will cause some warnings, as does the
  50.     compilation of lexer.c. The warnings can safely be ignored.
  51.  
  52.  
  53.     6.    Continue with the next section: Instructions on how to install
  54.     callback. 
  55.  
  56.  
  57. Instructions on how to install callback
  58. ---------------------------------------
  59.  
  60.     0.  Either you agree with the predefined paths, or you have recompiled the
  61.     software yourself. In any case: the binaries are now assumed present in
  62.     cb/, login/ and mgetty/.
  63.  
  64.  
  65.     1. become root
  66.  
  67.  
  68.     2. make a directory /conf/callback (or make your BASE_PATH, if you
  69.     changed the default in configure.h), accessible for root only.
  70.  
  71.  
  72.     3.    If callback is used in the dial-in mode, it can be used to control
  73.     your modem. If callback is used in the callback mode it can also 
  74.     be used to perform callbacks.
  75.  
  76.     If you want to use callback in the dial-in mode, do:
  77.  
  78.         build install dialin
  79.         cp examples/dialin.setup /etc/callback.setup
  80.  
  81.     Otherwise, you want to use callback in the callback mode. Then do:
  82.  
  83.         build install callback
  84.         cp examples/callback.setup /etc/callback.setup
  85.  
  86.     NOTE: /etc/callback.setup may be another file or in another location
  87.         if you altered the default settings in configure.h.
  88.  
  89.  
  90.     4.    Create a symlink from your path to the CALLACKDIR/cb program, e.g.,
  91.  
  92.         ln -s /conf/callback/cb /sbin/cb
  93.  
  94.  
  95.     5.  When using the tcsh, do: rehash.
  96.  
  97.  
  98.     6. Copy files from ./examples/ to your CALLBACKDIR, e.g.,:
  99.  
  100.     cp callback.iss *.ttyS2 /conf/callback
  101.  
  102.  
  103.     7. If you use modemline ttyS1 and/or ttyS3, change the extensions of the
  104.     *.ttyS2 files so as to reflect your (extra) modemline(s). If you use
  105.     multiple modem lines, make sure you have a set of files for each
  106.     modemline, e.g.,
  107.         *.ttyS1 if you use modemline ttyS1,
  108.         *.ttyS2 if you use modemline ttyS2,
  109.         *.ttyS3 if you use modemline ttyS3.
  110.  
  111.  
  112.     8. Make a symbolic link for each modemline you're using to the mgetty
  113.     program used to listen to the modem(s). E.g., do
  114.  
  115.         ln -s /sbin/mgetty /sbin/modem.ttyS2
  116.  
  117.  
  118.     9. Adapt inittab to reflect the situation at your system,
  119.        see the inittab example in the examples/ subdirectory,
  120.        and read the file callback.doc for more information.
  121.  
  122.  
  123.    10. Edit /etc/callback.setup to suit your system and callbackmode,
  124.  
  125.  
  126.    11. Do
  127.         chmod 600 /etc/callback.setup
  128.  
  129.  
  130.    12. Do
  131.         'cb init'
  132.  
  133.     to restart init. This loads the enable-files. The modem.ttyS?
  134.     processes should appear in your ps-list. They should go to sleep
  135.     shortly thereafter. 
  136.  
  137.     13. Done.
  138.  
  139.     Use cb to control your modem. If you used 'mode: calback', you
  140.     should be able to accept callback-requests from selected users,
  141.     as defined in your callback.setup file.
  142.  
  143.     Also, make sure that the registersetings of your modem is ok. Some
  144.     examples are given in the file 'callback.doc'
  145.